
 FindDrives
============

Program		FindDrives
Purpose		List file systems 
Author		Philip Ludlam
Version		0.10, Tuesday the 30th of April 2002
Copyright	(C) Philip Ludlam 2002



FindDrives - Submenus

Each submenu file (ADFS, IDEFS, LanMan98, etc.) is called with the 1st parameter (%0) as the drive name.
The SCSI menu has a second parameter (%1) which is either 'SCSI' or 'SCSIFS' depending on the installed hardware.

==

Option settings:
 For all filing systems (unless specified)

  Bit Meaning
   1  Don't show FS name. Not Resources or Pipe
   2  Show drive number rather than name.
        (Only if there is a suitable number.)
   3  Don't show sprite with menu option.
   4  Sub menu is the contents of the drives root directory rather than
        the FS submenu. Not for audio CDs

For Resources
This is a 2 character option. The first character specifies what the submenu
is. The second character specifies how the option is show on screen.
 1st Char Meaning
  $        Show root directory of Resources
  a        Show $.Apps directory of Resources
  f        Show $.Fonts directory of Resources
  r        Show $.Resources directory of Resources
  t        Show $.ThirdParty directory of Resources
  *        Show FS submenu (default).

 2nd Char Meaning
  d        Don't show sprite on menu option
  *        Show sprite on menu option (default).

Where * is anyother character or even nothing.

Due to the way Director works, the 2nd character setting will only have an
effect if the 1st character is '*' (the default).

==

FindDrives
==========

Filing sytems supported are NetFS (untested), NetPrint (untested), RamFS,
CDFS, SCSIFS and ResourceFS.

Code has been included for NetFS and NetPrint but I don't have Econet so it
has not been tested.


Command line options
====================

Command line options are case sensitive.

-fs is followed by a space separated list of filing system specifiers that
will be merged with the ones built into the program ie 5 8 23 26 37 46.a

A filing system specifier has the syntax <file system number>[.<options>]

The filing system number is defined by Acorn, PRM 2-19.

This is followed optionally by a fullstop '.' and a sequence of hex digits
or letters specifying what is to be displayed.

For ADFS, RAMFS, SCSIFS and CDFS the following are currently specified;
--------------------------------
The first character is for drive 0, the second for drive 1 etc.  The default
is 3 unless otherwise specified (see -default).  The sequence does not have
to be complete for all drives, in which case the default will be used for
any remaining drives.

1   Include the filing system name, eg "ADFS"
2   Include the media name if available, eg "HardDisc4" instead of the drive
number
4   Don't offer access except through CFS
8   Also offer CFS access, but ignored if drive empty
16  Use the 'Drive' menu. Note: this is mutually exclusive with numbers 4 and 8

Add these numbers together to give combinations.
eg Options 1 and 4 together is 5.  Upper case hex only please
*   Use the default for this drive.

A drive that does not exist will not be included so use "*" as a place
holder.  This will cause the default to be used if a drive is later added to
the system.  If no name is available then an option of 3 will be used.

eg 8.01007 means;
      8 Filing system number 8 ie ADFS
      . Start of options
      0 Ignore drive 0 even if it exists
      1 Show filing system name and drive number
      * Use the default for drive 2 if it exists
      0 Ignore drive 3
      3 Show the filing system name and substitute the media name for the
        drive number if it is available.
Any further drives, ie drives 5,6 and 7 in this example, will use the
default option (usually 3).

For ResourceFS the following are currently specified;
--------------
$   Include the root
a   Include Applications
f   Include Fonts (only the fonts in the ROM)
r   Include Resources


-default<number>
This specifies the default drive options.  The default default is 3.

-noList
Do not use the default list of filing systems at all.